home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Overload Trio 2
/
Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO
/
dir31
/
dpp210.zip
/
DPP.DOC
next >
Wrap
Text File
|
1994-06-15
|
26KB
|
513 lines
A PRIME PRODUCTION
█████▄ █▌█████▄ █▌█████▌▄█████▌█▌ █████▄ █▌ ▄█████▌█▌ █▌█████▌█████▄
▀█▌█▌ ▀█▌█▌ █▌ █▌█▌ ▀█▌█▌ █▌█▌ █▌ ▀█▌
█▌ █▌█▌█▌ █▌ █▌ █▌ █▌█▌ █▌ █▌█▌ █▌ █▌▐█ ▐█ █▌ █▌ █▌
█▌ █▌█▌█▌ ███▌█▌ █▌ █▌ █▌█▌ █▌ ▄█▌█▌ █▌ █▌ ▐█▐█ ███▌ █▌ ▄█▌
█▌ █▌█▌█▌ █▌█▌ █▌ ████▌█▌█▌ █████▀ █▌ ████▌█▌ ▐█ █▌ █████▀
█▌ ▄█▌█▌█▌ ▄█▌█▌ █▌ █▌ █▌█▌ █▌ █▌ █▌ █▌ ▐█ █▌ █▌▀█▄
█████▀ █▌█████▀ █▌ █▌ █▌ █▌█████▌ █▌ █████ █▌ █▌ ▐█ █████ █▌ ▀█
▐███▄▐███▄ ▄██▄
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄. ▄ █ ▄ █ ▄ █▌.▄▄▄▄▄▄▄▄▄▄▄▄▄▄
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄.▐█ █▐█ █▐█ █▌.▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
▄▄▄▄▄▄▄▄▄▄▄▄▄▄.▐███▀▐███▀▐█ █▌.▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
▐█ ▐█ █▌▐█ █▌
▐█ ▐█ ▐█ ▀██▀
version 2.10
by
Riku Aakkula & Jussi Moisio
What is DPP?...............................
Foreword...................................
Technical data.............................
Getting started............................
Detection..................................
Playing module.............................
Errors.....................................
Contacting.................................
Greetings..................................
╔══════════════╗
║ WHAT IS DPP? ║
╚══════════════╝
Digital Player Pro (DPP) is a module player. It reads the most
common module types (MOD, STM, S3M, FAR etc...) and outputs the
music on a wide variety of different soundcards and devices,
including the PC speaker. So, you don't necessary need to buy a
soundcard to use DPP. However, you are STRONGLY engouraged to
buy one. In sound quality money definitely makes a difference.
╔══════════╗
║ FOREWORD ║
╚══════════╝
DPP started as a very simple project. But as many projects tend
to do, DPP soon started to swell into a massive audio entertainment
system it is today :)
The first few versions were entirely coded by Riku Aakkula using
pascal (and assembler). Later I (Jussi Moisio) came along to
develop DPP: The Next Generation... ;> The whole program structure
was reprogrammed using C.
And what got it all started? The answer is very simple. A couple
of friends of Riku asked him to do a moduleplayer because they
didn't like any of the existing ones. And here is the result:
DIGITAL PLAYER PRO! Enjoy using it and remember to send us a
postcard if you really like DPP.
╔════════════════╗
║ TECHNICAL DATA ║
╚════════════════╝
Supported soundcards : GUS, SB family, PAS family, Aria and WSS.
Supported non-scards : Stereo-DAC, PC speaker and Covox
Supported module formats: MOD, S3M, STM, AMF, NST, 699, MTM and FAR
Supported processors : 386sx...486sx with MCP and 486...PENTIUM
Sampling rates : 4.4kHz...44.1kHz (depending on sound device)
DMAs, IRQs and I/O PORTS: All (selectable)
Playback : Surround/stereo/mono
FFT : 128 samples per second
Memory handling : Base memory (640kb), EMS memory (0-2048kb)
Programming language : 64% assembler and 36% C
Detection system : Autodetection
Channels : 1-16
Playing modes : Normal/quality
╔═════════════════╗
║ GETTING STARTED ║
╚═════════════════╝
The following pictures are screenshots from DPP. The picture areas
are separated by rows of equal signs (=).
===============================================================================
Digital Player Pro 2.00 (c) 1994 Riku Aakkula & Jussi Moisio
Syntax: DPP [options] modulename [[modulename]...] [@listfile] [options]
Use DPP -h to get some info!
c:\modules\_
===============================================================================
Above is an example of what you get when you type DPP at command
line (don't forget to press enter... ;) )
For the help screen below type DPP -h
===============================================================================
Digital Player Pro 2.00 (c) 1994 Riku Aakkula & Jussi Moisio
Syntax: DPP [options] modulename [[modulename]...] [@listfile] [options]
Use DPP -h to get some info!
┌──────────────────────────────────────────────────────────────────────────────┐
│ │
│ ≡ Digital Player Pro's HELP! ≡ │
│ ────────────────────────────── │
│ │
│ -Sxxxxx - Sampling rate (4000-44100) or (4-44) │
│ -Cx - Card (1=PC speaker, 2=Covox, 3=Stereo DAC, 4=Sound Blaster, 5=Sound│
│ Blaster Pro, 6=Sound Blaster 16, 7=Pro Audio Spectrum, 8=Pro │
│ Audio Spectrum +, 9=Pro Audio Spectrum 16, 10=Aria, 11=Windows│
│ Sound System, 12=Gravis Ultrasound) │
│ │
│ │
│ -Dx - DMA Channel x │
│ -Ix - DMA IRQ x │
│ -Px - Use port xxx (PC speaker = 42) │
│ -Q - Quality mode (8-bit cards) │
│ -N - No EMS │
│ -Axxx - Specify amount of EMS memory to use (256...2048kb) │
│ -L - Looping mode (loop inside each module) │
└──────────────────────────────────────────────────────────────────────────────┘
c:\modules\_
===============================================================================
For example, if you want to load a module called ICEFRONT.S3M
(greetz to Skaven, we like your music a lot!) you have to
enter the following line on the command line:
DPP ICEFRONT.S3M
This is the easy way out. It also is the safest way, because it
will allow DPP to detect the soundcard you have and the proper
settings for it.
However, there are situations where you need to take more control.
For example:
* You don't have a soundcard and want to play music with
PC speaker
* You have more than one soundcard installed and want to
specify the one to use
* The detection routines fail to detect your soundcard
You may also just want to try different configurations. On some
systems sound quality and system functionality may be improved
with proper settings.
Use the following command line options to control DPP:
-Cxx Selects the sound device to use. Values for xx:
1 = PC speaker
2 = Covox (mono DAC)
3 = Stereo DAC
4 = Sound Blaster
5 = Sound Blaster Pro
6 = Sound Blaster 16
7 = Pro Audio Spectrum
8 = Pro Audio Spectrum +
9 = Pro Audio Spectrum 16
10 = Aria
11 = Windows Sound System
12 = Gravis Ultrasound
-Pxxx Specify the base I/O port for the sound device
selected. For example, SB is usually at 220
(the base port addresses are in hex format).
PC speaker is at port 42.
-Dx Specify the DMA channel to use. Consult your
soundcard's manual to find out the channel your
card uses. Prepare for DMA conflicts when messing
with this option...
-Ixx Specify the IRQ number. This is also something you
should find out from the soundcard's manuals.
As with option -D, there is a danger of conflicting
with other programs/hardware you have installed.
-Q Use quality mode with 8-bit cards. This affects the
internal mixing routines and is a bit slower but
offers better sound quality.
-N Disable EMS using
-Axxx Specify amount of EMS memory to use. Xxx must be
between 256kb and 2048kb. If autodetected 1024kb
is not enough you can force DPP to use more EMS
than 1024 entering -Axxx to command line.
-L Looping mode. DPP don't loop inside each module
automatically. If there is more than one module
in the playing list DPP loads automatically next
module after the module ends.
Examples:
You have two soundcards, GUS and SB, installed in your computer.
You want you have your daily overdoze of Skaven but want to use
the old Soundblaster for a change.
DPP ICEFRONT.S3M -C4
This will force DPP to use SB, ignoring the other soundcards found
in the system. Default values are used for base port, DMA and IRQ.
You have a GUS installed, but your current boot selection doesn't
include drivers for GUS, so DPP won't detect GUS automatically.
Not wanting to reboot your computer but remembering that your GUS
is at base port 240 using DMA channel 1 and IRQ 11 you type:
DPP ICEFRONT.S3M -C12 -P240 -I11 -D1
You are a poor bastard and don't have any money to buy a soundcard
but you still want to use DPP because it's so great ;)
DPP ICEFRONT.S3M -C1
And your PC speaker screams like it never did before...
╔═══════════╗
║ DETECTION ║
╚═══════════╝
===============================================================================
Loading module...
■ Detect GUS at 240h
■ DMA IRQ: 5
■ DMA channel: 5
■ Using EMS memory
■ 10 module(s) in the playing list
===============================================================================
Above is the 'detection screen' which shows you that DPP is now
loading a module. You also see the soundcard DPP uses and the DMA
and IRQ settings for it. You can also see if DPP is using EMS memory
and how many modules are in the playing list.
╔════════════════╗
║ PLAYING MODULE ║
╚════════════════╝
Below you can see the main playing screen of DPP. This is where you'll
spend most of your time.
===============================================================================
Digital Player Pro 2.00 (c) 1994 Riku Aakkula & Jussi Moisio ICEFRONT.S3M
GUS at 38587 Hz 16bit stereo Song: Ice Frontier Pos: 04/20:12
Memory used by module 233kb Time: 00:40 Tempo: 8/125 Vol: 100%
┌─────────────────────┬───┬──────────┬──┬───┬──────────────────────────────────┐
│Titan.Horn.Reverse │C-4│SAMPLE OFS│64│LFT│■■ │
│SlamDrum.3.Reverb │C-4│ │64│RGT│ │
│SlamDrum.3.Reverb │C#4│ │64│LFT│ │
│ACGuitar.2.simple │C-5│ │64│RGT│ ■■■■■■■■│
│ACGuitar.2.simple │A#4│DELAY NOTE│30│LFT│ │
│CosmoSynth.Minor │C-5│ │64│RGT│ ■■■■■■■■■│
│BrassSynthLead.korg │G-4│PORTA DOWN│57│LFT│■■■■■■ │
│BrassSynthLead.korg │G-4│ │40│RGT│ ■■■■■■│
└─────────────────────┴───┴──────────┴──┴───┴──────────────────────────────────┘
┌──────────────────────────────────────╥───────────────────────────────────────┐
│Titan.Horn 32kb 7kHz║SlamDrum.3.Reverb 26kb 16kHz│
│Metal.Bass 1 3kb 16kHz║SynthBD.2.Chain 4kb 17kHz│
│Metal.Bass 3 2kb 16kHz║Tambourine.2 3kb 17kHz│
│Metal.Bass 2 2kb 16kHz║Another Cymbal 25kb 16kHz│
│BigBass.3.loop 11kb 13kHz║PowerPercussion.Reverb 19kb 16kHz│
│CosmoSynth.Major 18kb 6kHz║ │
│CosmoSynth.Minor 10kb 6kHz║ Komposed by Skaven/FC │
│BellVoice.WTSynth 8kb 13kHz║ │
│Jungle-Track.CGC.Looped 4kb 13kHz║ I can't seem to think │
│ACGuitar.2.simple 2kb 13kHz║ straight in this heat │
│Titan.Horn.Reverse 8kb 7kHz║ and moisture... That's │
│BrassSynthLead.korg 11kb 13kHz║ why this ended up short. │
│HardTech.HiHat 4kb 8kHz║ │
│HallBaseDrum.MIX.BD12+HD1 11kb 15kHz║ Greetings go to:
└──────────────────────────────────────╨───────────────────────────────────────┘
┌──────────── Scope ─────────────┐┌──────────┐┌────── Spectrum Analyzer ───────┐
│ ││ ││ │
│ ││ CARD ││ │
│ ││ ---- ││ │
│ ││ ││ │
│ ││ GUS ││ │
│ ▄││ ││ │
│ ▄ ▄ ▄▄▀ ▄▄ ▄ ▀ ││ Port:240 ││ │
│▄ ▀ ▀▀ ▀ ▄▀ ▄ ▀ ││ DMA: 5 ││ │
│ ▄ ▄ ▀ ││ IRQ: 5 ││ │
│ ▄▀ ▄▄▀ ▀ ▄ ▀ ▄ ││ ││ ▒ │
│ ▀ ││ ││ ▒ ▒ │
│ ││ MODE ││ ▒ ▒ │
│ ││ ---- ││ ▒ ▒ ▒ │
│ ││ ││ ▒▒▒ ▒ ▒ ▒ ▒ ▒ │
│ ││ Normal ││ ▒▒▒ ▒ ▒ ▒ ▒▒▒ ▒▒ ▒▒ ▒▒▒ │
│ ││EMS 1024kb││▒▒▒▒▒▒▒▒▒▒ ▒▒ ▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
│ ││ 486 ││▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
└────────────────────────────────┘└──────────┘└────────────────────────────────┘
===============================================================================
As you can see, the screen is divided vertically into five sections.
On the top line you can see the version number, names of two great
coders ;) and the current module's file name. This is the status bar.
The two lines below it show self-explanatory miscellaneous info.
The first framed region shows all the channels and their playing
status. Fields from left to right: sample name, note, command,
volume, panning and the stereo volume bars.
The section below it is the complete sample listing. For each sample
you can see name, size and the frequency the sample has been sampled
with. The arrows in the upper left or the lower right corner appear
when there are too many samples to fit in the window at once. You can
scroll the sample window with PgUp/PgDown.
The lowest three frames include scope, card/mode information and
the spectrum analyzer. S toggles the scope and A toggles the spectrum
analyzer.
Pressing H while playing brings up the help screen where you can see
the keys to control DPP:
===============================================================================
┌──────────────────────────────────────────────────────────────────────────────┐
│ │
│ Keys while playing │
│ ────────────────── │
│ │
│ │
│ ctrl+ - Load next module │
│ ctrl+ - Load previous module │
│ - Select previous channel │
│ - Select next channel │
│ ctrl+P - Pause / Resume module │
│ - Go to next pattern │
│ - Go to previous pattern │
│ P - Mute channel │
│ -/+ - Decrease / increase master volume │
│ F1 - F10 - Set master volume quickly │
│ {/} - Set tempo │
│ [/] - Set speed │
│ H - This help screen │
│ I - Infoscreen │
│ A - Activate Spectrum Analyzer │
│ S - Activate Scope │
│ PgUp/PgDn - Scroll sample list up / down │
│ M - Panning middle │
│ L - Panning left │
│ R - Panning right │
│ U - Surround sound │
│ ,/. - Smooth panning left / right │
│ D - DOS shell │
└──────────────────────────────────────────────────────────────────────────────┘
===============================================================================
The surround sound works only with 16-bit stereo cards but NOT with
GUS.
DOS shell is now added to Digital Player Pro because of a BIG pressure
from users. To get back to DPP from DOS shell type EXIT. In the shell
DPP don't load next module and therefore you have to get back to DPP
from shell while DPP loads a new module.
! ! ! YOU DON'T NEED ANYMORE MATH COPROSESSOR TO USE SPECTRUM ANALYZER ! ! !
There also is a small info screen but I'll just let you to find out
about that yourself.
╔════════╗
║ ERRORS ║
╚════════╝
Error messages are so simple that there is no reason to tell anything
more than the names of errors : FILE, MEMORY, CORRUPT and DETECTION.
Most of the errors you may encounter using DPP are simple enough so
I won't discuss them any further in here. You should be able to figure
them out yourself.
However, if something catastrophic happens (system crash, QEMM error,
formatted hard disk :), off board parity error... ), send us a
postcard (what the heck, you should do it anyway) and tell us all
about it. Maybe in the next version it will be fixed.
╔════════════╗
║ CONTACTING ║
╚════════════╝
┌─────────────────────────────────────────────────────────────────────┐
│ │
│ By mail: │
│ ──────── │
│ │
│ Riku Aakkula │
│ Katajakuja 4 │
│ SF-35600 Halli │
│ FINLAND │
│ │
│ │
│ InterNet: │
│ ────────── │
│ ra@jybox.jyu.fi (the fastest method to contact) │
│ │
│ BBS: │
│ ──── │
│ R.A.LAW (DPP WORLD DIST) +358-37-5849007 │
│ │
│ Leave messages to Riku Aakkula │
└─────────────────────────────────────────────────────────────────────┘
Newest version is always available at :
┌─────────────────────────────────────────────────────────────────────┐
│ │
│ BBS Open Speed Number Note │
│ --- ---- ----- ------ ---- │
│ R.A.LAW 24h 16.8k +358-37-5849007 CABiNET │
│ Maximus Filecenter #1 24h 14.4k +358-31-2132955 line 1 │
│ Maximus Filecenter #2 24h 16.8k +358-31-2133755 line 2 │
│ │
│ The Inner Circle 24h 14.4k +203-293-1471 USA │ │
│ The Maze of Madness 24h 14.4k +55-61-3613206 Brasilia│
│ Litterbox 24h 16.8k +49-5121-66728 Germany │
│ OPTiC iLLUSiONS BBS 24h 14.4k +1-902-827-5350 Canada │
└─────────────────────────────────────────────────────────────────────┘
See DPP.REV for revision history.
╔═══════════╗
║ GREETINGS ║
╚═══════════╝
SO WE WANT TO SEND SOME GREETINGS :
Riku Aakkula a.k.a Matrix :
Inter/PRiME, Alchemist/PRiME, Aksu/PRiME, Nixon/PRiME
Esa Hyytiä, Jussi Lahdenniemi/W, Otto Chrons/W, Marko Suovula/W,
Disperin/Admire, Juha Perälä, Tero Reunanen/W, Janne Tuominen,
Lasse Moisio, Jukka Sjöstedt, Jeremy Edman, Petri Kultaranta,
Mike Annand, Lasse Makkonen/W, Reflex, MrBiGG/Anarchy PC,
Altair/Anarchy PC, Petteri Kangaslampi/S2, Hessu Järvinen,
Jyrki Aakkula, Lemming/J!P, GORE/FC, Abyss/FC
and Brad Craig/Advanced Gravis + everyone in the PC scene...
Jussi Moisio a.k.a Jammer :
Inter/PRiME, Alchemist/PRiME, Aksu/PRiME, Nixon/PRiME
Major Tom, Jaakko Leinonen, Jussi Lahdenniemi/W, Otto Chrons/W,
members of SCUP, Hessu Järvinen, Jyrki Aakkula, Lasse Immonen,
Brad Craig/Advanced Gravis + everyone I didn't have time to
think of...
SPECIAL THANKS TO: Inter (Awesome bug-finder)
Brad Craig (Awesome support)
Otto Chrons (DSMI)
Esa Hyytiä (Original version of FFT unit)
Markku Halmetoja (Inspiration)
Skaven (Test material)
sincerely yours,
Riku Aakkula and Jussi Moisio